---
title: Migrando desde Jekyll
description: Consejos para migrar un proyecto existente de Jekyll project a Astro
type: migration
stub: true
framework: Jekyll
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

[Jekyll](https://jekyllrb.com) es un generador de sitios estáticos construido en Ruby.

## Principales similitudes entre Jekyll y Astro

Jekyll y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto:

- Jekyll y Astro son generadores de sitios estáticos, comúnmente utilizados para crear blogs.

- Jekyll y Astro te permiten [escribir tu contenido en Markdown y HTML](/es/guides/content/). Tanto Jekyll como Astro proporcionan algunas propiedades YAML especiales para el diseño de páginas y publicaciones de borrador no publicadas. Puedes continuar utilizando tus archivos Markdown existentes en Astro.

- Jekyll y Astro utilizan [enrutamiento basado en archivos](/es/guides/routing/) para crear páginas a partir de tus publicaciones de blog. Astro proporciona un [directorio especial `src/pages/` para todas las páginas y publicaciones](/es/basics/project-structure/#srcpages). Jekyll utiliza una carpeta especial similar llamada `_posts/` para tus publicaciones de blog en Markdown, aunque tus páginas del sitio pueden estar en otros lugares. La creación de nuevas publicaciones de blog debería resultar familiar.


## Principales diferencias entre Jekyll y Astro

Cuando reconstruyas tu sitio de Jekyll a Astro, notarás algunas diferencias importantes:

- Como Jekyll es principalmente una plataforma de blogs, incluye varias características de blog integradas que es posible que debas construir por tu cuenta en Astro. O bien, elige una [plantilla de inicio de tema de blog](https://astro.build/themes?search=&categories%5B%5D=blog) que incluya estas características. Por ejemplo, Jekyll tiene soporte integrado para etiquetas y categorías que encontrarás en varios temas de blog de Astro, pero no se incluye en un proyecto Astro básico.

- Jekyll utiliza plantillas Liquid para elementos de diseño reutilizables y plantillas. Astro utiliza [archivos `.astro` similares a JSX para plantillas y componentes](/es/basics/astro-components/). Cualquier archivo `.astro` puede ser un componente, un diseño o una página completa, y puede importar y renderizar cualquier otro componente de Astro. También puedes construir utilizando [componentes de otros frameworks de UI (p. ej. React, Svelte, Vue, Solid)](/es/guides/framework-components/) así como contenido o metadatos de [otros archivos en tu proyecto](/es/guides/imports/), como Markdown o MDX.


## Migrar de Jekyll a Astro

Para migrar un blog de Jekyll a Astro, empieza con nuestra plantilla inicial para blogs, o explora más temas de la comunidad para blogs en nuestro [mostrador de temas](https://astro.build/themes/).

Puedes pasar el argumento `--template` al comando `create astro` para empezar un nuevo proyecto de Astro con una de nuestras plantillas oficiales. O, puedes [comenzar un nuevo proyecto desde cualquier repositorio de Astro existente en GitHub](/es/install/auto/#plantillas-de-inicio).

  <PackageManagerTabs>
    <Fragment slot="npm">
    ```shell
    npm create astro@latest -- --template blog
    ```
    </Fragment>
    <Fragment slot="pnpm">
    ```shell
    pnpm create astro@latest --template blog
    ```
    </Fragment>
    <Fragment slot="yarn">
    ```shell
    yarn create astro --template blog
    ```
    </Fragment>
  </PackageManagerTabs>

Trae tus archivos Markdown existentes como contenido para [crear páginas en Markdown](/es/guides/markdown-content/), utilizando un [diseño de Markdown de Astro](/es/basics/layouts/#plantillas-de-markdownmdx) en lugar de una plantilla Liquid template. 

Gran parte de tu contenido de página HTML existente se puede convertir en  [páginas de Astro](/es/basics/astro-pages/), y además podrás [usar variables, expresiones similares a JSX e importaciones de componentes directamente en tu plantilla HTML](/es/basics/astro-syntax/#expresiones-similares-a-jsx).

Astro no tiene una propiedad `permalink` que acepte marcadores de posición. Es posible que debas leer más acerca del [enrutamiento de página en Astro](/es/guides/routing/) si deseas mantener tu estructura de URL existente. O bien, considera [configurar redireccionamientos en un host como Netlify](https://docs.netlify.com/routing/redirects/).

Para convertir otros tipos de sitios, como un portafolio o sitio de documentatión, mira más plantillas oficiales de inicio en [astro.new](https://astro.new). Encontrarás un enlace al repositorio de GitHub de cada proyecto, así como enlaces de un solo clic para abrir un proyecto de trabajo en los entornos de desarrollo en línea de StackBlitz, CodeSandbox y Gitpod.

## Recursos de la Comunidad

- Artículo de blog: [De regreso al futuro: La transición de nuestro blog de tecnología de Jekyll a Astro](https://alasco.tech/2023/09/06/migrating-to-astro/) (traducción al español).
